home *** CD-ROM | disk | FTP | other *** search
/ CD Exchange / CD Exchange - Volume 1.iso / graphics / utils / viewtek / viewtek.doc < prev    next >
Text File  |  1993-08-02  |  25KB  |  684 lines
  1.                                    Viewtek
  2.       A freely distributable picture and animation viewer for the Amiga
  3.  
  4.                          Written by Thomas Krehbiel
  5.                        (Another fine UBTASITE product)
  6.  
  7.                     Copyright © 1992,1993 Thomas Krehbiel
  8.                              All Rights Reserved
  9.  
  10.       (Notice how the 'tek' in Viewtek is not capitalized in any way.)
  11.  
  12.  
  13.  
  14.  
  15. Distribution, Copyright, Etc.
  16. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  17.    The Viewtek executables and documentation are Copyright © 1992,1993
  18. by Thomas Krehbiel, All Rights Reserved.
  19.  
  20.    Viewtek is NOT public domain.  The author retains all rights to the
  21. program.
  22.  
  23.    See "Distribution.doc" for details about distributing Viewtek.
  24.  
  25.  
  26. Disclaimer
  27. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  28.    No warranties of any kind are made as to the functionality of this
  29. program.  You are using it at your own risk.
  30.  
  31.  
  32. Note
  33. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  34.    This documentation assumes a basic familiarity with AmigaDOS and the Amiga
  35. interface.  If you aren't familiar with the concepts of files, directories,
  36. gadgets, windows, etc. you should consult your "Introduction to the Amiga"
  37. manual.  Another excellent source of information is your local Amiga users
  38. group.
  39.  
  40.  
  41. Brief Note On Viewtek 1.05
  42. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  43.    Viewtek 1.05 was distributed with the ImageFX 1.5 release.  Think of it
  44. as sort of a precursor to this version.  It was not a complete Viewtek
  45. release.  Please distribute this version instead of 1.05.
  46.  
  47.  
  48. Introduction
  49. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  50.    Viewtek is an picture and animation viewer utility designed for Workbench
  51. 2.0 and up.  It started out as a pretty simple project, but naturally it's
  52. developed into a large shambling behemoth of a program (well, sort of).
  53.  
  54.  
  55. Quickstart
  56. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  57.    From Workbench:  Double-click the VT program icon, and select one or
  58. more files from the resulting file requester to view images or animations.
  59.  
  60.    From CLI:  Type VT followed by one or more image files or directories.
  61.  
  62.    Use the left mouse button to proceed to the next image when viewing a
  63. batch of images.
  64.  
  65.  
  66. Viewing Commands
  67. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  68.    ESCAPE         Abort viewing immediately.
  69.  
  70.    BACKSPACE      Abort viewing current directory (when using 'ALL').
  71.  
  72.    LMB/RMB        Go to next picture (unless using the 'NOCLICK' option).
  73.  
  74.    SPACE          Will hold on the current picture, when using DELAY.
  75.  
  76.    S              Will save the currently displayed picture as an
  77.                   ILBM (you will be asked for an output filename).
  78.                   This only works on pictures; not animations (yeah,
  79.                   I know it would be nice to save frames from anims,
  80.                   but gimme a break here... I've only got 2 hands. :)
  81.  
  82.    ANY KEY        Go to next picture.
  83.  
  84.    CTRL+Arrows    Move image/anim around on the display (overscan position).
  85.  
  86.    Up Arrow       (Anim Only) Return to beginning of the animation.
  87.  
  88.    Right Arrow    (Anim Only) Pause/single step animation.
  89.  
  90.    Down Arrow     (Anim Only) Resume playing animation after paused.
  91.  
  92.    C              (Anim Only) Toggle "continuous" mode.
  93.  
  94.    F1             (Anim Only) Play animation as fast as possible.
  95.    F2             (Anim Only) Play animation at 60fps.
  96.    F3             (Anim Only) Play animation at 30fps.
  97.    F4             (Anim Only) Play animation at 24fps.
  98.    F5             (Anim Only) Play animation at 15fps.
  99.    F6             (Anim Only) Play animation at 12fps.
  100.    F7             (Anim Only) Play animation at 10fps.
  101.    F8             (Anim Only) Play animation at 5fps.
  102.    F9             (Anim Only) Play animation at 1fps.
  103.    F10            (Anim Only) Play animation at rate specified in ANIM file.
  104.  
  105.  
  106. Useage From CLI
  107. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  108.    Viewtek generally works better from CLI (assuming you can type), since you
  109. have more options immediately available to you.
  110.  
  111.    The basic syntax is:
  112.  
  113.       VT [options] <one or more files or directories>
  114.  
  115.    Typing VT ? will give you a brief, jumbled display of all available
  116. options like so:
  117.  
  118.    Files/M,AL=All/S,BU=BufSize/K/N,CF=Config/K,CL=Clip/S,CO=Cont/S,
  119.    DE=Delay/K/N,DF=Default/S,DI=Disk/S,DT=DataTypes/S,FO=Forever/S,
  120.    FP=FPS/K/N,HD=Hide/S,HI=Hires/S,IC=Iconify/S,IL=ILBM/S,IN=Info/S,
  121.    LA=Lace/S,LM=LowMem/S,LO=Lores/S,LP=Loop/K/N,MA=MaxFrames/K/N,
  122.    NB=NoBusy/S,NC=NoClick/S,ND=NoDisk/S,NL=NoLace/S,NS=NoScroll/S,
  123.    NT=NTSC/S,PA=Paused/S,PL=PAL/S,PO=Pointer/S,QU=Quiet/S,RE=Repeat/K/N,
  124.    S7=Super72/S,SA=Save/K,SC=ScreenMode/K,SP=Speed/K/N,SU=SuperHires/S,
  125.    UN=UnderScan/S,UT=Unit/K/N:
  126.  
  127.    See "Option Keywords" below for details about all available options.
  128.  
  129.  
  130. Useage From Workbench
  131. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  132.    Viewtek may be run from Workbench in several ways.
  133.  
  134.    1) Double-clicking on the Viewtek icon will bring up a requester asking
  135. for one or more files to view.
  136.  
  137.    2) You may use extended selection to highlight several picture or
  138. animation icons and, while holding shift, double-click on the Viewtek program
  139. icon.  The files selected will be shown.
  140.  
  141.    3) You may set Viewtek as the default tool for any picture or animation
  142. icon.
  143.  
  144.    See "Option Keywords" below for tool types that you may use in either
  145. the Viewtek icon or any picture project icon.
  146.  
  147.  
  148. Option Keywords
  149. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  150.    These options are available on the CLI command line, via. Workbench
  151. tool types, or in the configuration file.  Note that the abbreviations
  152. only work on the CLI command line; you must spell the options out from
  153. Workbench or in the configuration file.
  154.  
  155.  
  156.    File Handling Options
  157.    ~~~~~~~~~~~~~~~~~~~~~
  158.  
  159.    Files/M (CLI only)
  160.  
  161.       One or more files, directories, or patterns.  If you give VT a
  162.       directory, all files in that directory will be shown (in no
  163.       special order).  Standard AmigaDOS wildcards are supported.
  164.       Basically, anything that is not a recognizable option is assumed
  165.       to be a file spec.
  166.  
  167.    AL=All/S
  168.  
  169.       Tells VT to recursively enter subdirectories.
  170.  
  171.    CL=Clip/S
  172.  
  173.       Read image from clipboard.
  174.  
  175.    DE=Delay/K/N
  176.  
  177.       Number of seconds to show each picture or animation before
  178.       automatically proceeding to the next one.  The timer doesn't
  179.       start until *after* the picture or animation has been loaded.
  180.  
  181.    DT=DataTypes/S
  182.  
  183.       Force VT to use Datatypes to identify and display files (normally
  184.       datatypes is the last thing checked before giving up on a file).
  185.       This lets you, for example, use a datatypes GIF converter instead
  186.       of the one built into VT.
  187.  
  188.    DefaultDir/K (Workbench or Configuration File only) (2.0)
  189.  
  190.       Specify the directory where Viewtek will open its initial
  191.       file requester.
  192.  
  193.    FO=Forever/S
  194.  
  195.       Repeat showing the list of files given on the command line
  196.       forever and ever amen (and/or until cancelled).
  197.  
  198.    IL=ILBM/S
  199.  
  200.       Force VT to assume all files are ILBM pictures.  In case you only
  201.       want to show the first frame of an animation and not the whole
  202.       thing.
  203.  
  204.    NC=NoClick/S (2.0)
  205.  
  206.       Disable the standard method of using the mouse buttons to
  207.       skip to the next picture.  With this option enable, you will
  208.       have to use the keyboard.
  209.  
  210.    RE=Repeat/K/N
  211.  
  212.       Repeat showing the list of files given on the command line
  213.       the number of times specified (or until cancelled manually).
  214.  
  215.    SA=Save/K
  216.  
  217.       Save the resulting image that VT renders to a displayable
  218.       ILBM file.  Makes VT into a (*very*) simple file conversion
  219.       utility.  (NOTE: I have no plans to turn VT into a killer
  220.       awesome amazing wonderful convert-anything-to-everything-
  221.       else file converter.)
  222.  
  223.    UT=Unit/K/N
  224.  
  225.       Specify clipboard unit when showing contents of clipboar